Skip to content

docs: rename Protocol Overview to Base Protocol, merge into single page - #1867

Open
mindapivessa wants to merge 2 commits into
masterfrom
docs/base-protocol-rename
Open

docs: rename Protocol Overview to Base Protocol, merge into single page#1867
mindapivessa wants to merge 2 commits into
masterfrom
docs/base-protocol-rename

Conversation

@mindapivessa

@mindapivessa mindapivessa commented Aug 28, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Creates a Base Protocol group that nests Consensus, Execution, Bridging, Batcher, and Proofs under one dropdown — reducing top-level sidebar clutter and mirroring the protocol overview page structure.
  • Splits the overview into two pages: an Overview (architecture diagrams, network participants, protocol component summaries, core user flows) and a Design Goals page (philosophy, lineage).
  • Promotes Flashblocks and Batcher from single-page dropdown groups to top-level sidebar items.
  • Reorders protocol components: Overview → Consensus → Execution → Bridging → Batcher → Proofs → Design Goals.
  • Adds redirect from specs/protocol/overviewspecs/overview.
  • Updates IA guidelines and decision log to reflect the new structure.

Test plan

  • Run mintlify dev and verify Base Protocol group renders with correct nesting
  • Confirm ordering: Overview → Consensus → Execution → Bridging → Batcher → Proofs → Design Goals
  • Confirm Flashblocks appears as a top-level sidebar item (no dropdown)
  • Verify redirect from /base-chain/specs/protocol/overview works
  • Run /lint and confirm no errors

🤖 Generated with Claude Code

Combine specs/overview.mdx (design goals, lineage) and
specs/protocol/overview.mdx (architecture, diagrams, user flows) into
a single Base Protocol page. Promote Flashblocks from single-page
group to top-level sidebar item.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@cb-heimdall

Copy link
Copy Markdown
Collaborator

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@mintlify

mintlify Bot commented Aug 28, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
base 🟢 Ready View Preview Aug 28, 2026, 9:27 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Move Consensus, Execution, Bridging, Batcher, and Proofs under a
Base Protocol dropdown group. Split the merged overview into a
protocol overview page and a separate Design Goals page. Update
IA guidelines to reflect new structure.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants